home *** CD-ROM | disk | FTP | other *** search
/ Aminet 39 / Aminet 39 (2000)(Schatztruhe)[!][Oct 2000].iso / Aminet / comm / tcp / Tinyproxy-133.lha / tinyproxy-1.3.3 / README < prev    next >
Encoding:
Text File  |  2000-04-02  |  3.9 KB  |  102 lines
  1.  This is tinyproxy-adns, tinyproxy with support for GNU adns asynchronous
  2.  resolver library.
  3.  
  4.  DESCRIPTION
  5.  -----------
  6.  
  7.  tinyproxy is a small, efficient HTTP proxy daemon.  tinyproxy is very 
  8.  useful in a small network setting, where a larger proxy like Squid
  9.  would either be too resource intensive, or a security risk.  One of
  10.  the key features of tinyproxy is the buffering connection concept.
  11.  In effect, tinyproxy will buffer a high speed response from a server, 
  12.  and then relay it to a client at the highest speed the client will
  13.  accept.  This feature greatly reduces the problems with sluggishness
  14.  on the Internet.  If you are sharing an Internet connection with a
  15.  small network, and you only want to allow HTTP requests to be
  16.  allowed, then tinyproxy is a great tool for the network
  17.  administrator.
  18.  
  19.  This version of tinyproxy must be compiled with GNU adns, available from
  20.  http://www.chiark.greenend.org.uk/~ian/adns/.  You'll have to download
  21.  and install the latest version of this software in order to compile
  22.  tinyproxy.
  23.  
  24.  INSTALLATION
  25.  ------------
  26.  
  27.  To install this package under a Unix derivative, read the INSTALL
  28.  file.  tinyproxy uses a standard GNU configure script.  There are
  29.  additional command line arguments you can supply to configure.  They
  30.  include:
  31.  
  32.     --enable-debug        If you would like to turn on full
  33.                 debugging support
  34.     --enable-socks        This turns on SOCKS support for using
  35.                 tinyproxy across a fire wall.
  36.     --enable-xtinyproxy    Compile in support for the XTinyproxy
  37.                 header, which is sent to any web
  38.                 server in your domain.
  39.  
  40.     Options for GNU adns
  41.         --with-adns-include=DIR Set the directory in which adns.h has
  42.                                 been installed. Required if this is in
  43.                                 a non-standard location.
  44.         --with-adns-lib=DIR     Set the directory in which libadns.* have
  45.                                 been installed. Required if this is in
  46.                                 a non-standard location.
  47.  
  48.      Options for file locations etc.
  49.         --with-port=PORT        Set the port on which tinyproxy listens,
  50.                                 by default 8080.
  51.         --with-log-file=FILE    Set the default logfile location.
  52.         --with-user=USER        Set the default user to which tinyproxy
  53.                                 will setuid() upon startup.
  54.  
  55.  Once you have completed your installation, if you would like to
  56.  report your success please execute the report.sh script in the doc
  57.  directory.  This will send an email to the authors reporting your
  58.  version, and a few bits of information concerning the memory usage of 
  59.  tinyproxy.  Alternatively, you could just send an email stating the
  60.  version.  Which ever you prefer.
  61.  
  62.  SUPPORT
  63.  -------
  64.  
  65.  If you are having problems with tinyproxy, please report the problem
  66.  to:
  67.  
  68.     Steven Young        <sdyoung@well.com>
  69.     Robert James Kaes    <rjkaes@flarenet.com>
  70.  
  71.  If the problem seems to be to do with GNU adns support (or if I've done
  72.  something obviously wrong), please email
  73.  
  74.         Chris Lightfoot         <chris@ex-parrot.com>
  75.  
  76.  Please recompile tinyproxy with full debug support (--enable-debug)
  77.  and include a copy of the log file, and any assert errors reported by 
  78.  tinyproxy.  Also, if you feel up to it, try running tinyproxy under
  79.  your debugger and report the error your received and a context
  80.  listing of the location.  Under gdb you would run tinyproxy like so:
  81.  
  82.      gdb tinyproxy
  83.  
  84.      (gdb) set args -p port_num -l log_file -d
  85.      (gdb) run
  86.  
  87.  Now access the port tinyproxy is on until you receive a break in the
  88.  gdb. You can now type:
  89.  
  90.      (gbd) l
  91.  
  92.  to produce a context listing of the location of the error.  Send a
  93.  copy to the authors.
  94.  
  95.  HOW TO CONTRIBUTE TO tinyproxy
  96.  ------------------------------
  97.  
  98.  If you would like to contribute a feature, or a bug fix to the
  99.  tinyproxy source, please send a diff (preferable a unified
  100.  diff. i.e. "diff -u") against the latest release of tinyproxy.  Also, 
  101.  if you could include a brief description of what your patch does.
  102.